Skip to content

Call the baseline a validation baseline - #468

Merged
jeremymanning merged 2 commits into
mainfrom
docs/catalogue-validation-baseline
Aug 4, 2026
Merged

Call the baseline a validation baseline#468
jeremymanning merged 2 commits into
mainfrom
docs/catalogue-validation-baseline

Conversation

@jeremymanning

Copy link
Copy Markdown
Member

Addresses the review's point that the catalogue dashboard is not yet a product-support dashboard.

The problem with the old name

scripts/catalogue_validating.txt was described in the script as "the supported list". It records exactly one thing: which examples pass orchestrator validate.

That is not the same as:

  • running,
  • producing correct artifacts,
  • being tested,
  • being a supported product example.

One name carrying four claims is how a weak signal comes to be read as a strong one — and this signal is genuinely weak. 27 of the current failures are Undefined variable, which says nothing about whether the other 50 do anything useful.

The change

Renamed to scripts/catalogue_validation_baseline.txt (via git mv, so history follows), with the distinction stated in three places people actually read:

  • the file's own header,
  • the script's module docstring,
  • the CI job comment.

examples/supported/ remains the stronger contract: those are executed and their behaviour asserted. This file is the weaker, wider net, and now says so.

No behaviour change

The gate still fails when a named file leaves the baseline and still ignores the headline count. 831 passed, catalogue 50/117, all 50 baseline files still validate.

Still outstanding from the same review point

Moving the dashboard from scraped first-error text to stable error codes is separate, and is now genuinely possible: #467 exposes ValidationIssue.code through validate --json, so the report can consume structured findings instead of grouping human-readable strings. The semantic classification (supported / live-dependent / legacy / duplicate / archive) remains a judgement that lives in issue #104.

🤖 Generated with Claude Code

jeremymanning and others added 2 commits August 3, 2026 23:48
scripts/catalogue_validating.txt was described as 'the supported list'. It
records one thing: which examples pass 'orchestrator validate'. That is not
the same as running, producing correct artifacts, or being a supported
example, and one name for four different claims is how a weak signal gets
read as a strong one.

Renamed to catalogue_validation_baseline.txt, with the distinction stated in
the file itself, the script docstring and the CI job comment. examples/
supported/ remains the stronger contract: those are executed and their
behaviour asserted.

No behaviour change. The gate still fails on a named file leaving the
baseline and still ignores the headline count.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@jeremymanning
jeremymanning merged commit 758b5d3 into main Aug 4, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant